To purchase, simply launch the "MacSOS Registration"
software and add your details or open the URL
http://order.kagi.com/cgi-bin/r1.cgi?GG&
MacAT Overview
MacAT is a Windows AT/UNIX cron-like task scheduling application for Macintosh server administrators. It is a fat binary application that allows 22 of the most common MacOS tasks to be run on demand, once, hourly, daily, weekly, fortnightly, monthly or yearly without user intervention.
These scheduled tasks include:
-Sending eMail
-Compress Files and Folders
-Uncompress Files
-Bringing Applications to the Foreground (to maximise CPU usage)
-Hide Applications
-Launching Applications, Files and AppleScripts
-Quitting individual applications or alternatively quitting all currently running processes
-Open, Rename and Delete any File or Folder
-Mount remote AppleShare volumes automatically over AppleTalk (eg NT, MacOS, UNIX EtherShare, Linux Netatalk AppleShare Volumes)
-Copy Files or Folders to any mounted AppleTalk volume
-Unmount nominated AppleShare volumes
-Restart or shutdown the Macintosh
Each MacAT task result is automatically logged in the MacAT file and the number of logs per task can be set by the administrator.
MacAT could easily be used as a useful component of any MacOS server backup system (MacAT came about due to my own simple requirement that our MacOS servers were backed up nightly).
Requirements
MacAT needs to be running with an open 'crontab' file at all time.
MacAT requires MacOS System 7.1 but runs best under MacOS 8 or greater using the appearance manager (if installed).
MacAT runs as an application and does not add any extensions to your Macintosh System Folder.
MacAT contains both 68k and PowerPC native code ensuring maximum speed on all MacOS systems.
This is a full working version of MacAT. Registration removes the shareware reminders. You are welcome to pass this software onto others (MacAT will revert to an unregistered copy) but please don't pass on the registration number.
Only one MacAT crontab file can be opened at any one time. MacAT task files are saved automatically (like FileMaker Databases). This decision was taken so that as each task is performed, the results are recorded and saved. The number of logs for each AT task can be adjusted in the preferences window by the server administrator. The log information can be very useful if you have complex batches of tasks that aren't giving you the results you need.
AT task are processed synchronously but several AT jobs can be scheduled to run in the same minute (as long as the other task have finished inside that minute). Where possible allow plenty of time for each task to complete (eg allow 2-3 mins between AT tasks).
Most buttons in dialog windows can be selected from the keyboard (holding down the command key will cause the button to reveal the required key). In a similar fashion, the tab-panel log screens can also be navigated using the keyboard (simply press 1, 2 or 3)
Clicking on the table column headers in each task panel sorts the information (eg Status, Date, Result).
Clicking on the "Todays' Next AT Task" description selects that the next task in the task list.
Tasks that quit MacAT, Restart or Shut Down the Macintosh are logged before the task is performed and worded as if the command executed successful. If the task subsequently fails then another log is recorded, describing the failure.
Caution. Tasks that refer to aliases always refer to the real file or folder that the alias points to.
Launch Application
Any Macintosh application can be scheduled to run.
Bring Application To Front
Any running Macintosh application can be scheduled to be brought to the front. The application is not launched if is not running. (Consider just using a "Launch Application" task in this case).
Hide Application
Any running Macintosh application (except MacAT) can be scheduled to be hidden. Pretty boring really...
Quit Application
Requires the application to respond to the "quit" AppleEvent. As a required AppleEvent, almost every System 7 application should work. Use this command if you want to quit MacAT (the result will be logged).
Quit All Applications
MacAT sends the 'quit" AppleEvent to all open applications, including faceless background processes, (but excluding "File Sharing Extension"). Most faceless background MacOS components will start back up again automatically. MacAT will not attempt to quit the "Finder" or "MacAT".
Open File
Any Macintosh file, application or AppleScript cab be scheduled to run. Identical to "Launch Application".
Copy File
Copying files between AppleTalk File server volumes can take a while so allow plenty of time for this command to complete (eg 10 minutes before the next AT task is scheduled to run). This task will not replace an existing file. Consider scheduling a delete or rename task before copying/replacing).
Rename File
Any Macintosh file, application or AppleScript can be renamed. Files are renamed in place (ie in the same folder). To move a file consider scheduling an AT copy task followed by an AT rename task.
Delete File
Any Macintosh file, application or AppleScript can be deleted. No warning is given and the task can not be undone. Caution. Deleting an alias deletes the original.
Compress File & Folder, Uncompress File
Any Macintosh file, application or AppleScript can be compressed. The "Stuffit Engine", part of DropStuff from Aladdin Systems, http://www.aladdinsys.com, must be installed.
Copy Folder
Copying folders between AppleTalk File server volumes can take a while so allow plenty of time for this command to complete (eg 10 minutes before the next AT task is scheduled to run). All files and sub-folders are also copied. Aliases are not followed. This task will not replace an existing folder. Consider scheduling a delete or rename task before copying/replacing)
Rename Folder
Folders are renamed in place (ie in the same parent folder). To move a folder consider scheduling an AT copy task followed by an AT rename task.
Delete Folder
Any folder can be deleted even if it is not empty. All files and sub-folders are also deleted. Use at your own peril.
Caution. Deleting an alias of a folder deletes the original folder (and all the original folders contents).
Mount Volume
You need to mount the volume on the desktop before MacAT allows you to add the user name and password information. The AppleTalk Zone server information is calculated automatically. The mount volume command uses AppleTalk and works over LocalTalk, Ethernet and ARA connections. Mounting an AppleTalk volume is slow (and modal), so allow MacAT a couple of minutes to mount the volume before the next MacAT task is scheduled. This task will not mount AppleShare IP volumes if they cannot be mounted via AppleTalk.
Put Away Volume
You can put away every volume except the Boot Volume. You should avoid having multiple volumes on the desktop with the same name.
Restart Computer
This command will fail if other applications require user input (eg Save, Don't Save dialog windows)
Shut Down Computer
This command will fail if other applications require user input (eg Save, Don't Save dialog windows)
Send eMail
Use this command to automate sending regular eMail messages (eg monthly pay slip reminders). This task requires a valid: eMail address; return eMail address and SMTP server IP. Strict validation of the entered eMail addresses is not attempted. The TCP/IP subsystem must already be active otherwise this task will return an error (ie A PPP connection will not be automatically instantiated - the link must already be in place). Over a 28k modem PPP or ARA link, expect to take 2-5 seconds to send an eMail. With a permanent ethernet connection, the smtp process should take less than 1 second to complete. This task is really for Macintosh computers with a permanent network connection.
Brief explanation of the SMTP features:
The To: field holds the email address of who you are sending the mail to. You may separate multiple email addresses with commas. The From: field is used to tell the SMTP server what your ID is, and it sets the From: header. It MUST be in the form userid@host (eg. macsos@kagi.com).
The SMTP server is the server you wish to relay the mail through, probably your ISP's mail server. This can either be in the form of an IP address or a valid DNS name (eg hostname.domain).
Thoughts for Future Versions:
Mount AppleShare volumes over IP.
Open multiple MacAT files at once.
Move File and Folder tasks.
Replace File and Folder tasks.
Smaller RAM and disk space requirements.
Background faceless application engine while keeping the standard MacAT task-builder interface.
-Added "Hourly" to the list of schedule selections.
-Faster keydown timer setting to improve trapping of keyboard/button selections in MacAT windows.
-Tightened the checking when not selecting a month & date for "Yearly" schedule tasks.
-Added an Easter Egg.
-Removed close box from main AT list to make it harder to accidentally close the Mac crontab file.
-Reduced RAM requirements to less than 2MB.
-Enabled more keyboard navigation controls (eg pressing the spacebar edits the currently selected AT job).
v2.0
Released 10 Feb 1999.
-Added new task "Send eMail".
-Added eMail notification of task errors.
-Individual tasks can be turned on or off.
-Slightly widened the main task list to accommodate the extra task settings.
-Fixed a non-crashing bug where clicking the cancel button instead of selecting an application from the list of active applications failed to update the "Edit At Job" window.
-Added a self-closing notification alert. This alert automatically closes itself after several seconds to ensure that MacAT and the Macintosh server can continue unimpeded and is used extensively when SMTP processes fail. Note: eMail messages for failed task errors are not logged but rather a self-closing notification alert is posted.
v2.0.1
Released 10 Feb 1999.
-Fixed various non-crashing bugs where widgets did not deactivate in the background.
-Fixed various spelling mistakes in MacAT and documentation.
v2.0.2
Released 11 Feb 1999.
-Removed the problem where the "Put Away" task was not working reliably (due to a bug in the development environment REALbasic). The problem was fixed by replacing the Unmount XCMD with one written by Apple in the late 1980's).
v2.1
Released 18 Feb 1999.
-Added "Append Text Document" feature to outgoing "Send eMail" tasks (for those who need their log files emailed to them). Please note that I haven't attempted to strip any high ASCII characters (those greater than 128) from the appended text files. This may or may not be friendly to your smtp server. Let me know if you have any text files that contain strange characters that have problems when sending.
-Removed the command key " Q" from the "Quit" menu item.
v3.0
Released 3 March 1999.
-Added "Once" schedule.
-Added "Fortnightly" schedule. I believe that this schedule option is unique (on any platform) to MacAT.
-Added "Open Folder" task (used to activate Apple FolderAction Applescripts).
-Added "Hide Application" task.
-Added the ability to delete an individual tasks logs or all logs.
-Fixed crashing bug when "Put Away" task was performed repeatedly on a PPC. This bug appeared to be introduced by the Apple XCMD added in v2.0.2.
-Fixed cosmetic bug for "Yearly" tasked scheduled to run the first of the month.
Note: "Send eMail" task does not work on old Macintosh's which do not have Open Transport installed.
v3.1
Released 10 March 1999.
-Appear to have finally fixed the "Put Away" task. This was accomplished after integrating a new plugin, "FSPlugin" by Tim Spalone, instead of the previous unreliable XCMDs. Thanks to Mike Schon-Hegrad for beta testing the bugs out of this one.
-Added "Compress File", "Compress Folder" and "Uncompress File" tasks. These require the "Stuffit Engine" to be installed and configured.
-Fixed the visual bugs associated with the "Send email on failures" checkboxes.
v3.2
Released March 18 1999.
-Added a title field to each MacAT task. This field, if it contains any text, will be displayed on the main MacAT task list instead of the usual MacAT generated summary description line.
-Added more balloon help.
-Redesigned preferences window.
-Added Veronica to credits on "About MacAT..." page.
-Added sound notification for whenever any MacAT task fails. I don't want to add different sounds for individual tasks as that would be a little too much 'featuritus'.
-Started to add "Run missed AT tasks when MacAT starts up". I will try to complete for the next version.
-Added user definable font and fontsize for main AT task, log and history list boxes.
v3.5
Released 31 March 1999.
-Added "Hide main MacAT list window after launch" preference setting. When selected the main list will always be invisible after launching MacAT.
-Added new menu item "Toggle AT list". Use this to show/hide the main MacAT list window.
-Added confirmation dialogs when closing or quitting MacAT (even with hidden main MacAT list windows). This warning dialog does not appear when quitting MacAT with a MacAT task. You can set MacAT to not ask for confirmation to quit in the preferences window.
-Added a "Run AT Task" menu. This allows you to run the selected task immediately from the main MacAT list window.
-Added an "Insert MacAT tag" feature for the send email task. Allows the insertion of the 'date' and 'chooser name' when the mail is ultimately sent. Let me know if you have more suggestions for this command.
-Added on-screen notification of missed tasks. At launch, MacAT scans through the list of AT tasks and checks the last execution date. Tasks that should have been run (but were missed as MacAT was not launched) are flagged as 'missed'. The server administrator can then determine if they should be performed 'by hand' (using the new "Run AT Task" menu). MacAT does not automatically run missed tasks in case the tasks really were meant to be skipped.
-Tidied up a lot of the internal menu handling logic and code.
-Added a preference setting to re-enable the command key "Q" for the "Quit" menu item.
-Changed the command key for the Edit Task button in the Edit task window from "T" to "E".
v3.5.1
Released 1 April 1999.
-Fixed a bug when email attachments could not be found.
MacSOS grants a free 30 day license for use of this software (MacAT), starting from the date of receipt, after which time said software must be registered with MacSOS with appropriate compensation and registration forms. Under no circumstances may the software be used beyond the free 30 day licensing period unless the previously stated conditions have been satisfied. You must purchase a separate copy of the software for each Macintosh it is used on.
Unless explicitly stated in writing, MacSOS does not grant permission to distribute the software for profit in any form, including but not limited to, electronic information service distribution, bulletin board distribution, and magnetic or optical medium distribution. Non-profit distribution of the software is acceptable without prior written notice, providing that the software is not modified in any way, and the complete works of the software are included in the distribution package.
MacSOS is not responsible for any damage to the purchaser's computer system or data and in no event will MacSOS, its officers, directors, employees or agents be responsible to the purchaser for any consequential, incidental, or indirect damages (including damages for loss of business profits, business interruption, loss of business information and the like) arising out of the use or inability to use the MacSOS product, even if MacSOS has been advised of the possibility of such damages.
If you have any questions concerning the above license, please do not use this software.
